home *** CD-ROM | disk | FTP | other *** search
/ Shareware Super Platinum 8 / Shareware Super Platinum 8.iso / mac / PROGTOOL / EZY_INST.ZIP;1 / INSTALL.DOC < prev    next >
Encoding:
Text File  |  1994-07-08  |  7.4 KB  |  204 lines
  1. Simple Install
  2. Copyright LRC Computing, 1994-1995  All Rights Reserved
  3.  
  4. Included in this file:
  5. 1.  Legal Stuff
  6. 2.  Shareware Stuff
  7. 3.  You ARE Important
  8. 4.  Instructions for use
  9. 5.  Tutorial
  10.  
  11.  
  12. 1.  Legal Stuff:
  13.  
  14. I wrote it, I'll support it, but I will not be liable for any damages
  15. arising from the use or the inability to use this software.  This is a
  16. shareware product.  Try it and if it does not meet your requirements,
  17. delete it.  If you do have problems, contact me and I'll do my best to
  18. resolve the problem.
  19.  
  20.   The registered version may reside at only one site per license.  A
  21. site is defined as a single business at a single phsical location.
  22. Two different companies cannot use the same license regardless of
  23. location.  The software may be installed on as many PCs or on a LAN as
  24. needed, at a single site.
  25.  
  26.  
  27. 2.  Shareware Stuff:
  28.  
  29. As stated above, this is a shareware product.  You may try out this program
  30. for 30 days.  If at the end of that time you decide to continue using it,
  31. see the register.doc file.  You may not distribute software to your users
  32. with an unregistered version of this software.
  33.  
  34.  
  35. 3.  You ARE Important:
  36.  
  37. This software is written for you.  If you don't like something, would like
  38. something enhanced, or would like to see something added; PLEASE contact me.
  39. If I don't meet your needs you won't use my software. If you tell me your
  40. needs maybe I can meet them.  I would like to hear from registered AND
  41. unregistered users.
  42.  
  43. If you would like to see this software in a language other than english
  44. and are willing to do the translation, I will give you a free registered
  45. version of the software.
  46.  
  47.  
  48. 4.  Instructions For Use:
  49.  
  50. Simple Install is a script driven install program.  You don't need to
  51. learn a new language to use it.  There are 9 line identifiers, 3
  52. variables and 2 executables.  You do not need to use any of the
  53. variables but you must use 7 of the 9 line identifiers.  The script
  54. file is positional.  All text starts at row 1, column 1 (0,0 for the
  55. C programmers out there).  Line identifiers MUST be in the order
  56. below (See the 3 sample files; simpins1.dat, simpins2.dat and
  57. simpins3.dat).  The variables are for use on the closing screen.  One
  58. of the executables is for compressing your files, the other is the
  59. install program itself.
  60.  
  61. The line identifiers are listed below with a brief explanation:
  62.  
  63. title=      Title to be displayed on the screen
  64.             Centered, can be blank
  65. text=       Line 1 of descriptive text to be displayed on the screen
  66.             Centered, can be blank
  67. text=       Line 2 of descriptive text to be displayed on the screen
  68.             Centered, can be blank
  69. default=    Default installation directory
  70. files=      Number of files total to be extracted, instructs install.exe
  71.             as to how many times the following 2 line identifiers will be
  72.             iterated
  73.  
  74.             The next 2 line identifiers can be repeated as many times
  75.             as necessary (the number of times to be repeated is derived
  76.             from the above line identifier).
  77. file=       File name to be decompressed
  78. disk=       Disk number, this will increase sequentially for each disk
  79.             If other than file 1 and it resides on the same disk as the
  80.             file above it, use a zero or the same disk number as the file
  81.             above it
  82.  
  83.             The following 2 line identifiers are mutually exclusive.
  84.             If you include endtext= you may NOT include runcommand=.
  85.             Both are optional.
  86. endtext=    Optional.  This line identifier designates the start of
  87.             text to be displayed on the closing screen
  88.             Immediately after the = sign you need to put the number of
  89.             lines of text to be displayed, up to 20
  90.             On the lines below, type in the closing text exactly as you
  91.             want it to be displayed
  92.             Text will begin display on line 3, lines are 1 based
  93.             No formatting will be done
  94.  
  95. runcommand= Optional.  This line identifier identifies a command to be run
  96.             as the very last thing before the program exits to DOS.  It
  97.             can be any valid DOS command (dir, mem, chkdsk) or any program.
  98.             If it is a program, the program must either be in the DOS path,
  99.             in the current sub-directory, it must include a path as part of
  100.             the file name, or it must exist in one of the compressed files.
  101.             The screen will be cleared BEFORE the command is run.
  102.  
  103.  
  104. The variables are listed below with a brief explanation:
  105.  
  106. &output&    This is what you use to display the output path
  107. |outdrive|  This is what you use to display the output drive
  108. ;outdir;    This is what you use to display the output sub-directory
  109.  
  110. The executables are listed below with a brief explanation:
  111.  
  112. simpcom.exe   File compressor and archiver
  113. install.exe   Install program
  114.  
  115.  
  116. Tutorial:  
  117.  
  118. The datafiles for this tutorial are in a file called tutorial.sim and a
  119. file called tutorial.dat.
  120. Follow the following steps to prepare the tutorial for use.
  121.  
  122. a.  Copy tutorial.sim to an empty sub-directory.
  123. b.  Copy tutorial.dat into the same sub-directory.
  124. c.  Rename tutorial.dat to install.dat.
  125. d.  Copy install.exe to this sub-directory.
  126. e.  Type install and press enter.
  127. f.  Press enter again.
  128. You should now have the files and data structures for the tutorial.
  129.  
  130. Let's say you are a programmer and you have an application called
  131. 'WIDGET TRACKER' (how original, eh).  This application contains the
  132. following files and structures:
  133.  
  134.   widget.exe
  135.  
  136.     data\widget.dbf
  137.     data\help.dbf
  138.     data\help.dbt
  139.  
  140.     docs\user.doc
  141.     docs\register.doc
  142.     docs\read.me
  143.  
  144. First you need to compress your files.
  145.  
  146. To do this change to the sub-directory containing 'widget.exe' and type:
  147.   simpcom  widget.exe data1.lib                 --Press return
  148.   simpcom  data\*.dbf;data\*.dbt data2.lib      --Press return
  149.   simpcom  docs\*.doc;docs\read.me data3.lib    --Press return
  150.  
  151. You now have your archives.
  152. After compressing you realize data2.lib and data3.lib can both fit
  153. on the same floppy. 
  154.  
  155.  
  156. Now you fire up your favorite text editor and create an install.dat
  157. script file. (see simpins2.dat)
  158.  
  159. title=WIDGET Tracker
  160. text=This program will install WIDGET Tracker on your hard drive.
  161. text=Thank you for using this program.
  162. default=C:\widget
  163. files=03
  164. file=data1.lib
  165. disk=1
  166. file=data2.lib
  167. disk=2
  168. file=data3.lib
  169. disk=0
  170. endtext=09
  171.  The WIDGET Tracker
  172.  
  173.    WIDGET Tracker was installed at: &output&
  174.  
  175.    To run WIDGET Tracker, type
  176.  
  177.    |outdrive|
  178.    CD ;outdir;
  179.    WIDGET
  180.  
  181.  
  182. In place of the endtext you could have entered:
  183.  
  184. runcommand=myconfig.exe
  185.  
  186. This would have run myconfig.exe as long as it is a valid DOS command (dir,
  187. mem, chkdsk) or any program.  If it is a program, the program must either be
  188. in the DOS path, in the current sub-directory, it must include a path as part
  189. of the file name, or it must exist in one of the compressed files. (see
  190. simpins3.dat)
  191.  
  192. Or, you might not include endtext= or runcommand= and after installation the
  193. program will clear the screen and exit to DOS.  (see simpins1.dat)
  194.  
  195. Now to create your disks.
  196. Copy install.exe, install.dat, data1.lib, and read.me (the user may want
  197. to read this on the disk before installation) to a floppy.
  198. Copy data2.lib and data3.lib to another floppy.
  199.  
  200. That's it, you've just created your distribution floppies.  As the calls
  201. roll in you can duplicate your masters and impress your users.
  202.  
  203.  
  204.